Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 1 - Appearance Manager Reference / Appearance Manager Functions

Coordinating Colors and Patterns With the Current Theme /

SetThemeTextColor

NEW WITH THE APPEARANCE MANAGER

Sets an element's foreground color for drawing text to comply with the current theme.

pascal OSStatus SetThemeTextColor (
                     ThemeTextColor inColor,
                     SInt16 inDepth,
                     Boolean inIsColorDevice);

inColor

A value representing the color to which the foreground text is to be set; see "Appearance-Compliant Text Color Constants".

inDepth

The bit depth (in pixels) of the current graphics port.

inIsColorDevice

A Boolean value. Set to true to indicate that you are drawing on a color device. Set to false for a monochrome device.

function result

A result code. The result code appearanceBadTextColorIndexErr indicates that the text color index passed was not valid. For a list of other result codes, see "Result Codes".

DISCUSSION

The SetThemeTextColor function is typically used inside a DeviceLoop drawing procedure to set the foreground color for drawing text in order to coordinate with the current theme.